feat(ai-anthropic): support GCP Vertex for the antrophic adapter by flxwu · Pull Request #989 · TanStack/ai

flxwu · 2026-07-23T13:43:13Z

🎯 Changes

Add a narrow, version-tolerant AnthropicMessagesClient contract around beta.messages.create.
Add createAnthropicChatWithClient for preconfigured authentication and transport while preserving the existing API-key factories.
Verify compatibility with the official Vertex client and a newer Anthropic SDK declaration set.
Route the existing Anthropic E2E matrix through the injected-client path.
Document custom clients and include a minor changeset.

The adapter's request mapping, streaming, tools, media, usage, and structured-output behavior are unchanged. Authentication and endpoint-specific feature support remain the injected client's responsibility.

🧪 Verification

pnpm test:pr (281/281 affected targets succeeded; declaration scan clean)
pnpm --filter @tanstack/ai-e2e test:e2e (389 passed, 1 skipped; run on an isolated local port because 3010 was occupied)
Anthropic package unit, type, build, lint, and publint checks

✅ Checklist

I have followed the steps in the Contributing guide.
I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

This change affects published code, and I have generated a changeset.
This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

New Features
- Added support for creating Anthropic chat adapters with custom, pre-configured clients.
- Supports custom authentication, endpoints, headers, and compatible Anthropic transports, including Vertex-based clients.
- Expanded documented Anthropic capabilities, including Claude chat, thinking, tools, and structured outputs.
Documentation
- Added API reference and usage guidance for custom Anthropic clients.
Tests
- Added coverage confirming injected clients are used correctly and support compatible client implementations.

coderabbitai · 2026-07-23T13:43:42Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: ba412109-5260-4bf7-8bd7-6412ae9c6387

📥 Commits

Reviewing files that changed from the base of the PR and between 888e8b7 and e065ac7.

⛔ Files ignored due to path filters (1)

pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (12)

.changeset/anthropic-client-injection.md
README.md
docs/adapters/anthropic.md
docs/config.json
packages/ai-anthropic/package.json
packages/ai-anthropic/src/adapters/text.ts
packages/ai-anthropic/src/index.ts
packages/ai-anthropic/src/utils/client.ts
packages/ai-anthropic/tests/anthropic-adapter.test.ts
packages/ai-anthropic/tests/client-injection-type-safety.test.ts
testing/e2e/package.json
testing/e2e/src/lib/providers.ts

🚧 Files skipped from review as they are similar to previous changes (12)

packages/ai-anthropic/tests/client-injection-type-safety.test.ts
.changeset/anthropic-client-injection.md
README.md
packages/ai-anthropic/src/index.ts
docs/config.json
packages/ai-anthropic/package.json
packages/ai-anthropic/tests/anthropic-adapter.test.ts
testing/e2e/package.json
docs/adapters/anthropic.md
testing/e2e/src/lib/providers.ts
packages/ai-anthropic/src/utils/client.ts
packages/ai-anthropic/src/adapters/text.ts

📝 Walkthrough

Walkthrough

The Anthropic adapter now supports injected Anthropic-compatible Messages clients through createAnthropicChatWithClient. The change adds public types and exports, updates tests and e2e wiring, and documents the new factory.

Changes

Anthropic client injection

Layer / File(s)	Summary
Client contract and adapter configuration `packages/ai-anthropic/src/utils/client.ts`, `packages/ai-anthropic/src/adapters/text.ts`, `packages/ai-anthropic/tests/client-injection-type-safety.test.ts`, `packages/ai-anthropic/package.json`	Defines `AnthropicMessagesClient`, supports injected-client adapter configuration, and validates compatibility with Anthropic SDK client shapes.
Injected client adapter factory `packages/ai-anthropic/src/adapters/text.ts`, `packages/ai-anthropic/src/index.ts`	Routes requests through an injected client when provided, adds `createAnthropicChatWithClient`, and re-exports the new factory and types.
Consumer wiring and documented usage `packages/ai-anthropic/tests/anthropic-adapter.test.ts`, `testing/e2e/...`, `docs/adapters/anthropic.md`, `README.md`, `.changeset/...`, `docs/config.json`	Tests injected request routing, updates the e2e Anthropic provider, documents the factory, and records provider and release metadata changes.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Provider
  participant createAnthropicChatWithClient
  participant AnthropicTextAdapter
  participant InjectedAnthropicClient
  Provider->>createAnthropicChatWithClient: provide model and client
  createAnthropicChatWithClient->>AnthropicTextAdapter: construct adapter
  AnthropicTextAdapter->>InjectedAnthropicClient: call beta.messages.create
  InjectedAnthropicClient-->>AnthropicTextAdapter: return message stream

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 60.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title identifies Anthropic adapter support for GCP Vertex, which is a key outcome of the client-injection changes.
Description check	✅ Passed	The description explains the changes, verification, checklist completion, and release impact, including the required changeset.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

socket-security · 2026-07-23T13:44:09Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/@anthropic-ai/sdk@0.112.4
	npm/@anthropic-ai/vertex-sdk@0.19.0

View full report

coderabbitai

🧹 Nitpick comments (1)

packages/ai-anthropic/tests/client-injection-type-safety.test.ts (1)
1-18: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Place this unit test alongside its source.

This test covers packages/ai-anthropic/src/utils/client.ts but is located under packages/ai-anthropic/tests/. Move it to a colocated *.test.ts file beside the source.

As per coding guidelines, unit tests must be placed in *.test.ts files alongside the source they cover.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@packages/ai-anthropic/tests/client-injection-type-safety.test.ts` around
lines 1 - 18, Move the type-safety tests from the package-level tests directory
into a colocated *.test.ts file beside the client utility source, preserving
both expectTypeOf cases and their existing assertions.
Source: Coding guidelines

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@packages/ai-anthropic/tests/client-injection-type-safety.test.ts`:
- Around line 1-18: Move the type-safety tests from the package-level tests
directory into a colocated *.test.ts file beside the client utility source,
preserving both expectTypeOf cases and their existing assertions.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 13203040-11ca-436c-b87b-49b2da387ca3

📥 Commits

Reviewing files that changed from the base of the PR and between 347b61b and 61b574a.

⛔ Files ignored due to path filters (1)

pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (12)

.changeset/anthropic-client-injection.md
README.md
docs/adapters/anthropic.md
docs/config.json
packages/ai-anthropic/package.json
packages/ai-anthropic/src/adapters/text.ts
packages/ai-anthropic/src/index.ts
packages/ai-anthropic/src/utils/client.ts
packages/ai-anthropic/tests/anthropic-adapter.test.ts
packages/ai-anthropic/tests/client-injection-type-safety.test.ts
testing/e2e/package.json
testing/e2e/src/lib/providers.ts

luap2703 · 2026-07-23T14:33:37Z

Great!

coderabbitai · 2026-08-10T09:09:26Z

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

tombeckenham · 2026-08-10T09:09:36Z

Maintainer sweep: rebased onto main (force-with-lease). CI approval handled if it was waiting.

nx-cloud · 2026-08-10T09:13:19Z

🤖 Nx Cloud AI Fix Eligible

An automatically generated fix could have helped fix failing tasks for this run, but Self-healing CI is disabled for this workspace. Visit workspace settings to enable it and get automatic fixes in future runs.

_{To disable these notifications, a workspace admin can disable them in workspace settings.}

View your CI Pipeline Execution ↗ for commit e065ac7

Command	Status	Duration	Result
`nx affected --targets=test:sherif,test:knip,tes...`	❌ Failed	9m 38s	View ↗
`nx run-many --targets=build --exclude=examples/...`	✅ Succeeded	1m 57s	View ↗

☁️ Nx Cloud last updated this comment at 2026-08-10 09:33:36 UTC

flxwu changed the title ~~feat(ai-anthropic): accept preconfigured Messages clients~~ feat(ai-anthropic): support GCP Vertex for the antrophic adapter Jul 23, 2026

coderabbitai Bot reviewed Jul 23, 2026

View reviewed changes

flxwu mentioned this pull request Jul 23, 2026

feat(ai-anthropic): publish client injection backport SilkHubCo/ai#1

Merged

feat(ai-anthropic): accept preconfigured messages clients

e065ac7

tombeckenham force-pushed the codex/anthropic-client-injection branch from 61b574a to e065ac7 Compare August 10, 2026 09:09

Navigation Menu

Uh oh!

Uh oh!

feat(ai-anthropic): support GCP Vertex for the antrophic adapter - #989

feat(ai-anthropic): support GCP Vertex for the antrophic adapter#989
flxwu wants to merge 1 commit into
TanStack:mainfrom
flxwu:codex/anthropic-client-injection

flxwu commented Jul 23, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Jul 23, 2026 •

edited

Loading

Walkthrough

Changes

Sequence Diagram(s)

❌ Failed checks (1 warning)

Uh oh!

socket-security Bot commented Jul 23, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot left a comment

Uh oh!

luap2703 commented Jul 23, 2026

Uh oh!

coderabbitai Bot commented Aug 10, 2026

Uh oh!

tombeckenham commented Aug 10, 2026

Uh oh!

nx-cloud Bot commented Aug 10, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Uh oh!

Conversation

flxwu commented Jul 23, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

🧪 Verification

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram(s)

❌ Failed checks (1 warning)

Uh oh!

socket-security Bot commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

luap2703 commented Jul 23, 2026

Uh oh!

coderabbitai Bot commented Aug 10, 2026

Uh oh!

tombeckenham commented Aug 10, 2026

Uh oh!

nx-cloud Bot commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 Nx Cloud AI Fix Eligible

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

flxwu commented Jul 23, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jul 23, 2026 •

edited

Loading

socket-security Bot commented Jul 23, 2026 •

edited

Loading

nx-cloud Bot commented Aug 10, 2026 •

edited

Loading